List of business trips

This request returns a list of business trips.

Request syntax

POST https://b2b-api.go.yandex.ru/integration/2.0/travels/list

Request headers

Authorization: Bearer <OAuth-token>
OAuth access token. The steps to get a token are described in Getting started.

X-YaTaxi-Selected-Corp-Client-Id — client ID from the account. Required if multiple clients are available using the token.

Request body

Order data is transmitted in JSON format:

Field	Description	Format	Required
`name`	Filter by business trip name.	String	No
`date_from`	Start date of the filtering period.	String	No
`date_to`	End date of the filtering period.	String	No
`cursor`	Cursor for the next page.	String	No
`limit`	Maximum number of entries returned. Value from 1 to 10. By default 10.	Number	No

Response field description

The response may contain the following fields:

Field	Description	Format	Required
`travel_items`	List of business trips — an array of TravelItem objects. Only confirmed and paid trips are returned in the response; canceled and returned trips are not included.	Array	Yes
`next_cursor`	Cursor for the next page. To view the next page, you need to specify this cursor in the `cursor` field of the next request.	String	No

The structure of the TravelItem object:

Field	Description	Format	Required
`id`	Unique ID of the business trip.	String	Yes
`name`	Name of the business trip.	String	Yes
`date_from`	Start date of the business trip.	String	No
`date_to`	End date of the business trip.	String	No
`created_at`	Date and time the record created.	String	Yes
`hotel_reservations`	Hotel reservations — an array of HotelReservationItem objects.	String	Yes
`train_trips`	Train trips — an array of TrainsTrip objects.	Array	Yes
`avia_reservations`	Flight reservations — an array of AviaReservationItem objects.	String	Yes

The structure of the HotelReservationItem object:

Field	Description	Format	Required
`id`	Booking identifier.	String	Yes
`external_id`	Booking identifier on the supplier's side. This identifier is displayed on the "Orders and Reports" page.	String	Yes
`country`	Country.	String	Yes
`city`	City.	String	Yes
`hotel_address`	Hotel address.	String	Yes
`hotel_name`	Hotel name.	String	Yes
`room_name`	Room type.	String	Yes
`price`	Price.	String	Yes
`stars`	Number of stars.	String	No
`users`	Booking participants — an array of HotelReservationUserItem objects.	Array	Yes
`date_from`	Check-in date.	String	Yes
`date_until`	Check-out date.	String	Yes
`voucher_url`	Voucher link. The link is valid for a limited time — it's recommended to download the file upon receipt and save it.	String	No

The structure of the HotelReservationUserItem object:

Field	Description	Format	Required
`id`	ID of a user the hotel is booked for.	String	Yes
`fullname`	Full name of the user the hotel is booked for.	String	Yes

The structure of the AviaReservationItem object:

Field	Description	Format	Required
`id`	Booking ID.	String	Yes
`cost`	Flight cost — object Price.	Object	No
`extra_charge_cost`	Additional charges — Price object.	Object	No
`forward_trip`	Outbound flight — AviaTripInfo object.	Object	Yes
`backward_trip`	Return flight — AviaTripInfo object.	Object	No
`users`	Flight participants — an array of AviaReservationUserItem objects.	Array	Yes

The structure of the AviaReservationUserItem object:

Field	Description	Format	Required
`id`	ID of the user the ticket is purchased for.	String	Yes
`fullname`	Full name of the user the ticket is purchased for.	String	Yes
`price`	Ticket price — Price object.	Object	Yes

The structure of the AviaTripInfo object:

One-way flight. May include transfers.

Field	Description	Format	Required
`departure_city`	Departure city.	String	Yes
`departure_airport`	Departure airport.	String	Yes
`departure_time`	Departure time.	String	Yes
`arrival_city`	Arrival city.	String	Yes
`arrival_airport`	Arrival airport.	String	Yes
`arrival_time`	Arrival time.	String	Yes
`total_duration`	Total duration (minutes).	Number	Yes
`flights`	Flight segments — an array of AviaFlightInfo objects.	Array	Yes

The structure of the AviaFlightInfo object:

Field	Description	Format	Required
`airline`	Airline.	String	Yes
`airline_code`	Airline code.	String	No
`flight_number`	Flight number.	String	No
`departure_city`	Departure city.	String	Yes
`departure_airport`	Departure airport.	String	Yes
`departure_airport_code`	Departure airport code.	String	Yes
`departure_time`	Departure time.	String	Yes
`arrival_city`	Arrival city.	String	Yes
`arrival_airport`	Arrival airport.	String	Yes
`arrival_airport_code`	Arrival airport code.	String	Yes
`arrival_time`	Arrival time.	String	Yes
`total_duration`	Flight duration (minutes).	Number	Yes
`baggage_info`	Baggage information — an array of AviaBaggageInfo objects.	Array	No

The structure of the AviaBaggageInfo object:

Field	Description	Format	Required
`pieces`	Number of pieces of luggage.	Integer	Yes
`weight`	Baggage weight (kg).	Integer	Yes
`size`	Baggage size (cm).	Integer	Yes
`is_cabin`	Cabin baggage (`true`/`false`).	Boolean	Yes

The structure of the TrainsTrip object:

Train trip.

Field	Description	Format	Required
`id`	Trip ID.	String	Yes
`trip_parts`	Route parts — an array of TrainsTripPart objects.	Array	Yes
`blank_url`	Link to the ticket form. The link is valid for a limited time — it's recommended to download the file upon receipt and save it.	String	Yes

The structure of the TrainsTripPart object:

One part of the train trip route. Contains information about the direction, train, etc.

Field	Description	Format	Required
`trip_part_id`	ID of the trip part.	String	Yes
`departure_city`	Departure city.	String	Yes
`departure_station_code`	Departure station code.	String	Yes
`departure_station_name`	Departure station name.	String	Yes
`arrival_city`	Arrival city.	String	Yes
`arrival_station_code`	Arrival station code.	String	Yes
`arrival_station_name`	Arrival station name.	String	Yes
`departure_time`	Departure time.	String	Yes
`arrival_time`	Arrival time.	String	Yes
`total_duration`	Duration (minutes).	Number	Yes
`direction`	Direction. Possible values: `forward` — there, `backward` — back.	String	Yes
`train_number`	Train number.	String	Yes
`train_name`	Train name.	String	No
`train_description`	Train description.	String	No
`is_ticket_print_required`	It's required to print the ticket.	Boolean	No
`reservations`	List of reservations — an array of TrainsReservation objects.	Array	Yes

The structure of the TrainsReservation object:

Contains information about the carriage, seat, etc.

Field	Description	Format	Required
`id`	Reservation ID.	String	Yes
`booking_number`	RZD booking number.	String	No
`total_cost`	Total cost — Price object.	Object	Yes
`refund_cost`	Refund amount — Price object.	Object	No
`users`	Passengers — an array of TrainsReservationUserInfo objects.	Array	Yes
`place_type`	Seat type. Possible values: `NoValue` `SeparateCompartment` `SideLowerNearRestroom` `SideUpperNearRestroom` `ThirdShelf` `Foldable` `Upper` `Lower` `Usual` `LastKupeLower` `LastKupeUpper` `Middle` `WithBicycle` `SideLower` `SideUpper` `NearPlayground` `NearTablePlayground` `NearTable` `WithPets` `MotherAndBaby` `WithChild` `NearPassengersWithPets` `Invalids` `InvalidsLower` `InvalidsUpper` `Negotiations` `NearTableForward` `NearTableBackward` `NoTableForward` `NoTableBackward` `NoWindowForward` `NoWindowBackward` `SingleForward` `NearRestroom` `FoldableNearRestroom` `NearRestroomAndBackward` `NearRestroomAndForward` `NoTableAndNoWindow` `Side` `WithoutPlace` `WithHigherLevelOfNoise` `FoldableOrWithHigherLevelOfNoise` `SideLowerWithHigherLevelOfNoise` `SideUpperWithHigherLevelOfNoise` `AisleSeat` `AisleSeatWithHigherLevelOfNoise` `UpperInTwoPlaceCompartment` `LowerInTwoPlaceCompartment` `LastCompartmentLowerWithHigherLevelOfNoise` `LastCompartmentUpperWithHigherLevelOfNoise`	Array	No
`service_class`	Service class.	String	Yes
`car_number`	Car number.	String	Yes
`car_description`	Car description.	String	Yes
`car_type`	Car type. Possible values: `Shared` — General `Soft` — Luxury `Luxury` — SV `Compartment` — Compartment `ReservedSeat` — Platskart `Sedentary` — Seated `Baggage` — Baggage	String	Yes
`cabin_gender_type`	Gender in the compartment. Possible values: `male` `female` `combined` `nondef` `none`	String	No
`is_bedding_included`	Bedding included.	Boolean	No
`service_cost`	Cost of additional services — Price object.	Object	Yes
`car_services`	Additional services in the car. Array of strings. Possible values: `Bedclothes` — Bed linen `Meal` — Meals `Wifi` — Wi-Fi `Tv` — Television `HygienicKit` — Sanitary and hygienic kit `Press` — Reading materials `AirConditioning — Air conditioner` `BioToilet` — Biotoilet `Plaid` — Blanket `WashbasinInCompartment — Washbasin` `ShowerRoomInCompartment — Shower` `HygienicShower` — Hygienic shower `Socket220V` — Socket 220V `Slippers` — Slippers `PetsCarriage` — Pet transportation `PlacesForPassengerWithBaby` — Sests for passengers with children `Transfer` — Transfer `RestaurantCarOrBuffet` — Restaurant car or buffet compartment `LuggageCompartment` — Luggage compartment `ShowerRoomInTrain` — Shower in the train `Safe` — Safe `ImprovedServices` — A carriage with enhanced features `HighComfortWaitingRoomServices` — Services of high-comfort waiting rooms `InfotainmentService` — Information and entertainment service `HotDrink` - Hot drinks `UsbSocket` - USB socket `ExcursionService` - Guided-tour services `PanoramicSalon` - Panoramic salon `MediaPlayer` - Media player `Iron` - Iron `IroningBoard` - Ironing board	Array	No
`place_reservation_type`	Type of seat reservation purchase. Possible values: `Usual` `TwoPlacesAtOnce` `ThreePlacesAtOnce` `FourPlacesAtOnce` `SixPlacesAtOnce`	String	No
`compartment_number`	Compartment number.	String	No
`arrival_time`	Arrival time.	String	No
`additional_information`	Additional information.	String	No
`carrier`	Carrier.	String	No

The structure of the TrainsReservationUserInfo object:

Contains information about the train passenger.

Field	Description	Format	Required
`id`	User ID.	String	Yes
`fullname`	User's full name.	String	Yes
`places`	Seat numbers.	Array of integers	Yes
`cost`	Cost per seat — Price object.	Object	Yes

The structure of the Price object:

Price with currency.

Field	Description	Format	Required
`value`	Amount. For example: `1000.00`, `150.50`.	String	Yes
`currency`	Currency code (e.g., RUB, USD).	String	Yes

Request example

POST https://b2b-api.go.yandex.ru/integration/2.0/travels/list
...
Authorization: Bearer <OAuth-token>
X-YaTaxi-Selected-Corp-Client-Id: <client-id>

  {
    "name": "Moscow 13.08.2025 - 14.08.2025"
  }

Response example

An example of a response to this request looks as follows:

{
  "travel_items": [
    {
      "id": "0507669f-0387-41ac-9f4d-a4514a5739f0",
      "name": "Moscow 13.08.2025 - 14.08.2025",
      "created_at": "2025-07-02T13:48:40.862011+00:00",
      "hotel_reservations": [
        {
          "id": "02a4add7-d052-4c7f-a957-e5572f5785fe",
          "external_id": "12345678",
          "country": "Russia",
          "city": "Moscow",
          "hotel_address": "Pushkina Street, Building 1, Moscow",
          "hotel_name": "Mini-Hotel on Pushkina Street",
          "room_name": "BUDGET DOUBLE ROOM WITH 1 BED WITHOUT WINDOW (BUNK BED, SHARED BATHROOM ON THE FLOOR)",
          "price": {
            "value": "2766.06",
            "currency": "RUB"
          },
          "users": [
            {
              "id": "098bfbffb02648c88caccc047def2446",
              "fullname": "Ivanov Ivan"
            }
          ],
          "date_from": "2025-08-13",
          "date_until": "2025-08-14",
          "stars": 2,
          "voucher_url": "VOUCHER_URL"
        }
      ],
      "train_trips": [
        {
          "id": "16b0b75b-60e5-4df3-8d78-7c342f2725ab",
          "trip_parts": [
            {
              "trip_part_id": "de412d52-bf38-463e-901a-946c8be79752",
              "departure_city": "SAINT PETERSBURG",
              "departure_station_code": "2004001",
              "departure_station_name": "SAINT PETERSBURG-MAIN",
              "arrival_city": "MOSCOW",
              "arrival_station_code": "2006004",
              "arrival_station_name": "MOSCOW OKTYABRSKAYA",
              "departure_time": "2025-08-13T09:00:00+00:00",
              "arrival_time": "2025-08-13T12:58:00+00:00",
              "total_duration": 238,
              "direction": "forward",
              "train_number": "759A",
              "reservations": [
                {
                  "id": "20b4d5b7-83a1-4b42-aecd-0d233b8ba43e",
                  "total_cost": {
                    "value": "5031.20",
                    "currency": "RUB"
                  },
                  "users": [
                    {
                      "id": "098bfbffb02648c88caccc047def2446",
                      "fullname": "Ivanov Ivan",
                      "places": [
                        49
                      ],
                      "cost": {
                        "value": "5031.20",
                        "currency": "RUB"
                      }
                    }
                  ],
                  "service_class": "2C",
                  "car_number": "06",
                  "car_description": "U0",
                  "car_type": "Sedentary",
                  "service_cost": {
                    "value": "117.60",
                    "currency": "RUB"
                  },
                  "car_services": [],
                  "booking_number": "75600963602640",
                  "place_type": "NoWindowBackward",
                  "cabin_gender_type": "none",
                  "place_reservation_type": "Usual",
                  "compartment_number": "23"
                }
              ],
              "train_name": "SAPSAN",
              "is_ticket_print_required": false
            }
          ],
          "blank_url": "BLANK_URL"
        }
      ],
      "avia_reservations": [
        {
          "id": "66592711-51fc-4dd6-80ba-722d8f00fbe7",
          "forward_trip": {
            "departure_city": "Moscow",
            "departure_airport": "Domodedovo Airport",
            "departure_time": "2025-08-14T17:00:00+00:00",
            "arrival_city": "Saint Petersburg",
            "arrival_airport": "Pulkovo Airport",
            "arrival_time": "2025-08-14T18:30:00+00:00",
            "total_duration": 90,
            "flights": [
              {
                "airline": "Ural Airlines",
                "departure_city": "Moscow",
                "departure_airport": "Domodedovo Airport",
                "departure_airport_code": "DME",
                "departure_time": "2025-08-14T17:00:00+00:00",
                "arrival_city": "Saint Petersburg",
                "arrival_airport": "Pulkovo Airport",
                "arrival_airport_code": "LED",
                "arrival_time": "2025-08-14T18:30:00+00:00",
                "total_duration": 90,
                "airline_code": "U6",
                "flight_number": "124",
                "baggage_info": [
                  {
                    "pieces": 1,
                    "weight": 10,
                    "size": 0,
                    "is_cabin": true
                  }
                ]
              }
            ]
          },
          "users": [
            {
              "id": "098bfbffb02648c88caccc047def2446",
              "fullname": "Ivanov Ivan",
              "price": {
                "value": "3897.00",
                "currency": "RUB"
              }
            }
          ],
          "cost": {
            "value": "3797.00",
            "currency": "RUB"
          },
          "extra_charge_cost": {
            "value": "100.00",
            "currency": "RUB"
          }
        }
      ],
      "date_from": "2025-08-13",
      "date_to": "2025-08-14"
    }
  ]
}

Response codes

The response to this request may contain the following standard HTTP codes:

200 — the request was successfully completed.
403 — the client doesn't have sufficient permissions to execute this request.
- SELECT_CLIENT_HEADER_REQUIRED — the request doesn't include the X-YaTaxi-Selected-Corp-Client-Id header (returned if there's more than one client for the token).
- SELECTED_CLIENT_ACCESS_DENIED — this login doesn't have access to the client ID provided in the X-YaTaxi-Selected-Corp-Client-Id header.
429 — request limit exceeded.

Was the article helpful?

List of vehicles

Air